home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 018a / mcroade3.zip / EDITM.DOC < prev    next >
Text File  |  1991-06-14  |  5KB  |  122 lines
  1.                              EditM.wpm
  2.                 Enables Use of External Text Editor
  3.             for Editing Macros from Within WordPerfect
  4.  
  5.                                 by
  6.  
  7.                       Jeffrey S. Kane, Ph.D.
  8.                 Performance Sciences International
  9.                           Summerfield, NC
  10.  
  11. 1.   Read the MacroAde.doc and Disclaim.er files distributed with this
  12.      macro.
  13.  
  14. 2.   Requires:
  15.      
  16.      A.   WordPerfect 5.1
  17.  
  18.      B.   The presence of the following files in the directory
  19.           where your WordPerfect macro files reside:
  20.  
  21.           1)   EditMac.bat
  22.           2)   Macrolst.exe
  23.           3)   MCompile.exe
  24.  
  25. 3.   Features:
  26.  
  27.      A.   Enables the user to utilize his/her favorite external
  28.           text editor (e.g., QEDIT, MultiEdit, VEDIT, Norton
  29.           Editor,...Edlin?) to edit any macro while staying within
  30.           a keystroke of returning to the place in a WordPerfect
  31.           document from which the macro editing originated.
  32.      
  33.      B.   The edited macro is recompiled and ready for use as soon
  34.           as the user returns to WordPerfect from the editing
  35.           session.
  36.  
  37.      C.   In short, allows the user to gain the advantage of all
  38.           the power and familiarity of his/her text editor to edit
  39.           macros without any sacrifice in convenience.
  40.  
  41. 4.   Installation:
  42.  
  43.      A.   Copy the following files to the directory in which your
  44.           WordPerfect macros are located:
  45.  
  46.           1)   EditM.wpm
  47.           2)   EditMac.bat
  48.           3)   Macrolst.exe
  49.           4)   MCompile.exe
  50.           5)   Commands.ref
  51.  
  52.      B.   If your macro files are NOT located in 'D:\WP51\', then
  53.           edit the EditM.wpm macro using WordPerfect's macro editor
  54.           (Ctrl-F10  EditM  2).  Change the value assigned to the
  55.           "WPMDir" variable in the header section to the directory
  56.           in which your macro files are located.  Be sure to put
  57.           the closing "\" at the end of any other directory you
  58.           enter.
  59.  
  60.      C.   At the DOS command line change to the directory in which
  61.           your macro files are located.  Use your text editor to
  62.           edit the file, EditMac.bat.  When you bring this short
  63.           batch file up on your editor's screen you'll see a
  64.           comment section that instructs you to change the next
  65.           command line to reflect the command needed to start your
  66.           editor on the file designated by the batch parameters
  67.           %2%1.LST.  Follow these instructions precisely and then
  68.           save the file.
  69.  
  70.      D.   With the completion of the above steps, installation is
  71.           finished.
  72.  
  73. 5.   Operation:
  74.  
  75.      To edit a macro with your external text editor without leaving
  76.      WordPerfect, simply run the EditM macro (ALT-F10  EditM 
  77.      [ENTER]).  You will then be prompted to enter the name of the
  78.      macro you wish to edit.  You need only enter the name without
  79.      the .wpm (although the .wpm extension will be accepted).  The
  80.      macro will then shell to DOS where the batch file will take
  81.      over.  An ASCII text version of the macro will be created by
  82.      MACROLST and you will be placed in an editing session on that
  83.      file using your text editor.  Make any changes that you wish
  84.      to make to the macro.  For assistance in the syntax of macro
  85.      and keystroke commands, bring up the Commands.ref file in a
  86.      separate window in your editor.  It contains all of the
  87.      commands as well as the number codes for the keystroke
  88.      commands.  When you're finished, save the macro file and exit
  89.      the editor.  The compiler will take over at that point and
  90.      recompile the macro.  You'll then be returned to your
  91.      WordPerfect document at the place whence you began the macro
  92.      editing.
  93.           Note that if either the name of the macro is mis-
  94.      specified or an error occurs during the attempt to recompile
  95.      the edited macro, the errors are caught and their correction
  96.      is required before the process can proceed further.  In the
  97.      case of mis-specifying the macro name, the user is simply
  98.      alerted to the fact and returned to WordPerfect where he/she
  99.      can try again.  If an error occurs during compilation, the
  100.      user is returned into his/her editor to correct the problem. 
  101.      If for some reason you don't want to be returned to the editor
  102.      (e.g., you've tried to fix the problem numerous times with no
  103.      success), just press Ctrl-BREAK at the point where you're told
  104.      to press any key and respond with 'Y' to the prompt 'Cancel
  105.      Batch Job (Y/N)?'.  This will cause the original version of
  106.      the .wpm macro file to be restored and you'll be returned to
  107.      WordPerfect at the place from which you started the attempt to
  108.      edit the macro.
  109.  
  110. 6.   Technical support:
  111.  
  112.      Free technical support will be furnished to any licensed user
  113.      who calls on weekdays during the hours from 9:00 a.m. to 5:00 p.m.
  114.      (Eastern) at the following number:  (919) 643-3492
  115.  
  116.      We may also be reached by mail at:
  117.  
  118.      Performance Sciences International
  119.      Suite 1250
  120.      3001 Latta Drive
  121.      Summerfield, NC  27358
  122.